OLA 文档中心

主题

2026-07-24

获取最近更新错误 - SoftUpdateGetLastError ​

函数简介 ​

读取最近一次更新失败摘要（.ola_update\logs\last_error.txt / 状态中的错误信息），便于脚本快速展示。

也可直接调用 SoftUpdateGetLastStatus：无日志/成功 → Code=1；有失败日志 → Code=0 并带失败文案。

返回数据格式：

json
{
  "Code": 1,
  "Message": "file md5 mismatch",
  "Error": "file md5 mismatch",
  "LogFile": "update_20260723_185000.log",
  "LogDir": "C:\\App\\.ola_update\\logs",
  "Phase": "failed"
}
字段名类型说明
Code整数1 表示读取成功。
Message字符串错误摘要。
Error字符串错误摘要（与 Message 同义，兼容字段）。
LogFile字符串详细日志文件名。
LogDir字符串日志目录。
Phase字符串失败时所在阶段。

接口名称 ​

SoftUpdateGetLastError

DLL调用 ​

long SoftUpdateGetLastError(string installRoot);

参数说明 ​

参数名类型说明
installRoot字符串安装根目录。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
OlaSoftUpdateLastErrorReturn err = ola.SoftUpdateGetLastError("C:\\App");
// err.Message / err.Error / err.LogDir
csharp
using OLAPlug;

var ola = new OLAPlugServer();
OlaSoftUpdateLastErrorReturn err = ola.SoftUpdateGetLastError(@"C:\App");
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
json_result = ola.SoftUpdateGetLastError(r"C:\App")
# Python SDK 返回 JSON 字符串，需自行解析
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.OlaSoftUpdateLastErrorReturn;

OLAPlugServer ola = new OLAPlugServer();
OlaSoftUpdateLastErrorReturn err = ola.SoftUpdateGetLastError("C:\\App");
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
err := ola.SoftUpdateGetLastError(`C:\App`)
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let err = ola.soft_update_get_last_error(r"C:\App");
cpp
var ola = com("OlaPlug.OlaSoft")
var err = ola.SoftUpdateGetLastError("C:\App")
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
Set err = ola.SoftUpdateGetLastError("C:\App")
text
.局部变量 ola, OLAPlug
.局部变量 err, OlaSoftUpdateLastErrorReturn
ola.创建 ()
err ＝ ola.SoftUpdateGetLastError(“C:\App”)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var json = ola.SoftUpdateGetLastError("C:\\App");
// Aardio SDK 返回 JSON 字符串，需自行解析
text
变量 ola <类型 = OLAPlugServer>
变量 err <类型 = OlaSoftUpdateLastErrorReturn>
ola = 新建 OLAPlugServer
err = ola.SoftUpdateGetLastError("C:\App")
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
OlaSoftUpdateLastErrorReturn err = ola.SoftUpdateGetLastError("C:\\App");

原生 DLL 调用 ​

cpp
long ptr = SoftUpdateGetLastError("C:\\App");
if (ptr != 0) {
    char buffer[2048] = {0};
    GetStringFromPtr(ptr, buffer, sizeof(buffer));
    FreeStringPtr(ptr);
}
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringFromPtr(long ptr, StringBuilder lpString, int size);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int FreeStringPtr(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringSize(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long SoftUpdateGetLastError(string installRoot);

long ptr = SoftUpdateGetLastError(@"C:\App");
if (ptr != 0) {
    StringBuilder sb = new StringBuilder(GetStringSize(ptr) + 1);
    GetStringFromPtr(ptr, sb, sb.Capacity);
    FreeStringPtr(ptr);
    string result = sb.ToString();
}
python
from ctypes import CDLL, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ptr = ola.SoftUpdateGetLastError(b"C:\\App")
if ptr:
    buf = create_string_buffer(2048)
    ola.GetStringFromPtr(ptr, buf, 2048)
    ola.FreeStringPtr(ptr)
    result = buf.value.decode("utf-8")

返回值 ​

调用方式返回值说明
SDKOlaSoftUpdateLastErrorReturn结构化错误对象
原生 DLL非 0成功，返回 JSON 字符串指针
原生 DLL0失败

注意事项 ​

项目说明
详细排障打开 LogDir 下对应的 update_*.log 会话日志。
成功清理更新成功后日志会被删除，此时错误摘要通常为空。
释放内存原生返回指针需 FreeStringPtr。